home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
utils
/
x10ec130.zip
/
X10ECDOS.EXE
/
X10EC.DOC
< prev
next >
Wrap
Text File
|
1996-05-31
|
62KB
|
1,324 lines
--------------------------------------------------------------------
X10EC - X10 Event Control
--------------------------------------------------------------------
Version 1.30
May 1996
Copyright 1993-1996 - D.Huras - All Rights Reserved
-----------------------------------------------X10EC.DOC v1.30------
CONTENTS
--------------------------------------------------------------------
1. DESCRIPTION 14. SAVE OPTIONS
2. REQUIREMENTS 15. INTELLIGENT EDIT
3. WARRANTY 16. UNDOCUMENTED CP290 COMMANDS
4. FEATURE OVERVIEW 17. INCREMENTAL BRIGHTENING
5. QUICK START INSTRUCTIONS 18. DIRECT COMMAND PAD
6. INSTALLATION INSTRUCTIONS 19. LAST UPLOAD DATE/TIME
7. COMMAND LINE ARGUMENTS 20. CP290 ICON STORAGE
8. PROGRAM OVERVIEW 21. BATCH MODE PROCESSING
9. KEYBOARD USAGE 22. COMPATIBILITY ISSUES
10. START UP OPTIONS 23. PROBLEM RESOLUTION
11. COMMUNICATION PORTS 24. REGISTRATION INFORMATION
12. SCREEN DISPLAY OPTIONS 25. UPGRADE INFORMATION
13. SUN TIME PARAMETERS 26. RELEASE HISTORY
27. ACKNOWLEDGEMENTS
1. DESCRIPTION
--------------------------------------------------------------------
X10EC is an Event Scheduler for the X10 CP290 Computer Interface(*1)
with many distinguishing features. X10EC is a full-screen DOS
program that uses a simple point & click user interface. (A Mouse
though not required is highly recommended). X10EC is designed to be
robust software that is processor speed independent; however, the
overhead required for the user interface is significant and a 286 or
above processor is recommended. This program is shareware and you
are invited to evaluate it for 30 days. If you continue to use the
program after the 30-day evaluation period you are asked to register
it. The author retains all rights to the program.
(*1) The CP290 Computer Interface is a device manufactured by X-10
that can be connected to a microcomputer serial port. The CP290
also plugs into an electrical outlet and it is through this
connection that the CP290 imposes X-10 commands onto the powerline.
X-10 commands use the power line as a carrier; other X-10 devices
connected to the power line will respond to these commands (ie.
switch ON/OFF lights, appliances).
2. REQUIREMENTS
--------------------------------------------------------------------
- An IBM-Compatible PC with at least 1 serial port.
- An X10 CP290 Computer Interface attached to a serial port.
- A Microsoft-Compatible Mouse is highly recommended
- A Colour adapter/display is recommended although the program
should run with a monochrome display/adapter. If you
experience problems with the default colors, then try the /BW
command line argument which will set everything to Black &
White.
The program requires approximately 525K available conventional memory
to run. The program will attempt to run if less than 525K is
available; however, depending on the number of Events/Devices
loaded and the number of modeless Windows opened, an 'Out of Memory'
error may occur. X10EC will forewarn you of a low memory situation
during program startup. You can reduce the memory requirements
somewhat by foregoing the online Help Sub-system (See STARTUP
OPTIONS).
3. WARRANTY
--------------------------------------------------------------------
X10EC is supplied as is. The author disclaims all warranties,
expressed or implied, including, without limitation, the warranties
of merchantability and of fitness for any purpose. The author
assumes no liability for damages, direct or consequential, which may
result from the use of X10EC.
4. FEATURE OVERVIEW
--------------------------------------------------------------------
- User-Friendly point & click DOS character-based Interface.
- Most program functions can be controlled using a mouse; minimal
keyboard intervention is required.
- Supports Standard CommPorts 1 thru 4 and a User Defined CommPort
that can support any IRQ between 1 & 15 (inclusive) and any
Base I/O Address.
- SUPPORTS * 5 * UNDOCUMENTED CP290 Commands.
- Pop-up X-10 Direct Command Pad w/UNDOCUMENTED CP290 Command Support.
- Compatible with the X10.DAT file format used by X10.EXE
(X10.DAT files can be read, created, updated and written).
- Supports X10.EXE 'Frozen' Events
- Supports Relative Times (Sunrise/Sunset +/- Offsets) and can be
setup to observe Daylight Savings Time.
- Stores ALL EVENT information (including Sunrise/Sunset Offsets
and Last Upload Date/Time) within the CP290
- Optionally synchronizes CP290 or PC Clock upon Event Upload.
- CP290 & PC Clock Setting/Synchronizing Function
- EVENTS can be programmed without touching the keyboard
(using a mouse)
- EVENTS can be sorted using one of 3 sort criteria's
- Flexible EVENT Scheduling; Program EVENTS from a DEVICE List
Window -OR- an EVENT List Window
- 'Intelligent' Edit (referential integrity) automatically
updates EVENTS when you change a DEVICE House/Unit address
- Merge Events from any number of X10.DAT files into one X10.DAT
file (up to the CP290 maximum of 128 Events).
- Merge Device Descriptions from any number of X10.DAT
files into one X10.DAT file
- Runs in batch mode to recycle Sunrise/Sunset times after
a user specified number of days have passed since the last upload
- Runs in batch mode to replace the CP290 Event Schedule with
the Events contained within an X10.DAT file.
- Detects and exploits EGA/VGA 43/50 line mode
- A comprehensive on-line Help sub-system that can be disabled
at the user's option to decrease program load time.
- The program WILL load without a CP290 Interface attached, however
all attempts at serial communications will result in errors; the
program will attempt to trap all such errors.
5. QUICK START INSTRUCTIONS
--------------------------------------------------------------------
These instructions are targetted for experienced users who wish
to get up & running quickly without reading this entire document:
1) Install X-10 Event Control to a sub-directory of your choice;
preferably NOT the same sub-directory where X10.EXE resides.
2) If you have a relevant X10.DAT file, then copy it to the
sub-directory where you have installed X10EC.EXE; if you don't
have an X10.DAT file X10EC can build one for you.
3) If your CP290 is on CommPort 1, then run X10EC without any
command line arguments; otherwise use the /Cn argument where
n = CommPort (for non-standard IRQ/Base_IO_Address set up see
COMMUNICATION PORTS section).
4) a) X10.DAT File AVAILABLE
X10EC will load the Devices and Events from your X10.DAT
file and display them in the DEVICES and EVENTS Windows
respectively. If the EVENTS in your X10.DAT file are not
up to date, then 'Download Events' using the 'Transfer'
menu item. When the Events have been downloaded they
will be matched against your DEVICES; any Events for
house/unit codes that are not defined as a DEVICE will
show up as 'Unnamed Device' - click on 'Name Device' to
name these Devices.
b) X10.DAT File NOT AVAILABLE
X10EC will load and attempt to load Devices & Events from
an X10.DAT file (that doesn't exist); each load attempt
will abort, click on OK to continue. You will see an
empty EVENTS window, use the 'Download Events' menu item
under 'Transfer' to populate your EVENTS Window. Now
scroll through the EVENT List and click on 'Name Device'
for each 'Unnamed Device'; type a Description and/or
Location for each.
5. SAVE your X10.DAT file; press CTRL-S.
6. EDIT existing DEVICES and/or EVENTS by double-clicking
the list item your wish to change. (or click on Modify once
you've highlighted the list item). You can apply as many edits
as you wish and experiment with the program. NO CHANGES WILL
BE UPLOADED TO YOUR CP290 UNTIL YOU EXPLICITLY UPLOAD THEM
USING THE TRANSFER MENU. Similarly, no changes will be
written to your X10.DAT File until you explicitly use the
SAVE Menu. X10EC will prompt you to save your X10.DAT File
if any changes were made to the Devices or Events when you
Exit the program UNLESS you use the Unconditional Exit which
quickly Exits the Program without prompting you to save
anything.
6. INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------
There are no special installation instructions; simply run the
SETUPDOS program will will extract files from the X10ECDOS.EXE file.
X10EC will look for 3 files in the directory it is run from. However,
the program will run with or without the following 3 files:
1) X10EC.INI
The X10EC.INI file is a text file containing all program
parameters; there is no need to create this file yourself
since the program will generate one whenever you select the
'Save Options' menu item. If an X10EC.INI file is not found
(which will be the case the first time X10EC run), X10EC
will revert to program defaults. A sample X10EC.INI file
(generated by X10EC.EXE) is shown below.
2) X10EC.HLP
X10EC retrieves the on-line help text from this file. If the
file is not found then X10EC will continue loading however
the help feature will be disabled. If you wish to reduce
X10EC's memory requirements, you can uncheck 'Load Help'
from the Startup Options screen, or use the /NH command
line argument.
3) X10.DAT
The default X10 Startup File is X10.DAT; X10EC will attempt
to retrieve Device Descriptions and Events from this file
in order to populate the DEVICES and EVENTS Windows respectively.
An X10.DAT file is a file format used by the X10 program
supplied by X10 with the CP290 interface. From the Startup
Options screen you can instruct X10EC to look for the Startup
X10 File on any drive/sub-directory. Conversely, you can
instruct X10EC to NOT retrieve Devices and/or Events from
an X10.DAT file upon Program Startup; in this case X10EC
will open empty DEVICES and EVENTS Windows.
;
; X10EC.INI File Created: 08-28-1994 11:37:30
; All Lines prefixed with ; are ignored
; ---------------------------------------------------------
;
; CommPort=1,2,3 OR 4 DEFAULT=1
;
[Communications]
CommPort=2
;
[Startup]
LoadDevices=YES
LoadEvents=FILE
X10File=X10.DAT
SyncClockOnUpload=CP290
UseCP290IconStorage=YES
LoadHelp=YES
ConfirmDeletes=YES
AutoRefreshDeviceNames=YES
AutoRefreshEventCounts=YES
SaveX10FileUponRecycle=YES
RefreshClocks=5
LinesPerPage=60
UseBoxChars=YES
;
[Display]
ThreeD=YES
Shadows=YES
Graphics=YES
;
; Colour Values
; -------------
; 0=Black 4=Red 8=Gray 12=Bright Red
; 1=Blue 5=Magenta 9=Bright Blue 13=Pink
; 2=Green 6=Brown 10=Bright Green 14=Yellow
; 3=Cyan 7=White 11=Bright Cyan 15=Bright White
;
BackColor=7
ForeColor=0
HiLiteKey=14
DisabledItem=8
MenuBackColor=1
MenuForeColor=7
MenuSelectedBackColor=0
MenuSelectedForeColor=7
LabelBackColor=9
LabelForeColor=11
HiliteText1ForeColor=4
HiliteText2ForeColor=1
HiliteText3ForeColor=14
HelpTitleBackColor=5
HelpTitleForeColor=15
StatusTitleBackColor=4
StatusTitleForeColor=15
WarningTitleBackColor=12
WarningTitleForeColor=15
;
[SunParms]
LatitudeDegrees=43
LatitudeMinutes=39
LatitudeNS=N
LongitudeDegrees=79
LongitudeMinutes=49
LongitudeEW=W
GMTOffSetHours=5
GMTOffSetMinutes=0
GMTOffSetPlusMinus=-
ObserveDST=YES
;
; End of X10EC.INI (11:37:30)
This X10EC.FILE was created using the 'Save Options' menu item.
7. COMMAND LINE ARGUMENTS
--------------------------------------------------------------------
DEFAULTS: If the program is run without any command line arguments
it will default to COMMPORT 1.
The following command line arguments can be entered in any order:
/Annnn(n) - Base I/O Address applicable to User Defined CommPort
(Must be specified as a decimal number)
If /I agrument is present, but /A is not; then Base
I/O Address will default to 1016 (3F8 Hex).
/BYD - Bypass DEVICES (ie. Do not load; ignore LoadDevices INI directive)
/BYE - Bypass EVENTS (ie. Do not load; ignore LoadEvents INI directive)
/BW - Use Monochrome colours (Black & White)
/Cn - COMMPORT where n = 1,2,3 & 4
/F:[d]\filename - X10.DAT Startup File Specification
where [d] = drivespec eg. /F:C:\X10\X10.DAT
/In - IRQ applicable to User Defined CommPort where n = 1 - 15
If /A argument is present, but /I is not; then IRQ
will default to 4.
/NH - Do Not Load HELP Sub-System
/NH- - Load HELP Sub-System (Override INI directive)
* The following 2 arguments run X10EC in Batch Mode *
/RECYCLEnn - Perform Recycle Process (Can be abbreviated as /Rnn)
where nn = number of elapsed days since last upload (0-99);
X10EC will examine the X10EC.LOG file and only continue the
Recycle Process if nn days have elapsed. If nn is not
present 0 is assumed and Reycle will run unconditionally.
Optionally save EVENTS to RECYCLE.DAT file if 'Save X-10 File
upon RECYCLE' is checked on the Startup Options screen.
/UF:[d]\filename - Clear CP290 Event memory and upload X10.DAT file
where [d] = drivespec eg. /F:C:\X10\X10.DAT
COMMAND LINE OPTIONS OVERRIDE CONTRADICTING X10EC.INI SETTINGS.
8. PROGRAM OVERVIEW
--------------------------------------------------------------------
X10EC has been designed to be flexible so that the user controls the
program rather than the program controlling the user. There are a
variety of options that let the user determine how the program will
respond in certain instances including Program Startup. The DEVICES
and EVENTS Windows are the 'cornerstones' of the program but they do
not limit the user to performing Device related activities in the
DEVICES Window or Event related activities in the EVENTS Window.
For example, if you spot an EVENT in the Events Window and notice
that there is no Device Description for it, you can simply highlight
the Event and click on the 'Name Device' button; an 'Insert Device'
window will pop up with the House and Unit code preset from the
highlighted Event. Once you have entered the Device Location and/or
Description it will be propagated to all Events in the EVENTS Window
that have targetted that particular house/unit code. Similarly,
while in the DEVICES Window (which provides you a Count of how many
Events have been scheduled for each Device), you may notice that a
particular Device has no Events scheduled. In this case, you can
simply highlight the Device and click the 'Schedule Event' button
and an 'Insert Event' window will pop up with the Device Description
already filled in.
When X10EC loads, it looks at the Startup Options to determine if
Devices and/or Events are to be loaded. Devices can only be loaded
from an 'X10.DAT' file whereas Events can be loaded from either the
same X10.DAT file or downloaded from the CP290. Loading Events from
the file is faster than downloading them, but you may want to ensure
you're always working with current information by waiting for the
download. (Also, if you've RECYCLE'd your Events you may want to
see what the Relative Times were for the last RECYCLE iteration; in
this case you should download the Events). If you have defined
devices across multiple X10.DAT files, you can merge them all
without disturbing the currently loaded Events. Use the 'Retrieve
Devices ONLY' menu item; X10EC will ask you if you want to replace
the loaded Devices with the Devices from the File OR if you want to
append the Devices from the File; select Append to merge the
Devices. Note that any time X10EC loads Devices it will discard
duplicate descriptions; it will also sort Devices by House/Unit code
in support of the referential integrity features offered by X10EC.
The Event Counts displayed in the DEVICES Window refer to
single-unit Events, Group and Global Events are not included in
these counts. You can also merge Events from multiple X10.DAT files
up to the CP290 maximum of 128 Events; use the 'Retrieve Events Only'
menu item. If there are vacant event slots available then X10EC will
ask you if you want to merge or replace Events.
Once you've loaded Devices/Events, you can update them freely. The
Insert, Modify, & Delete buttons will behave as expected. To use the
Modify or Delete button you must have highlighted an entry from the
List box. Instead of clicking the Modify button you can double
click the list item (or press the spacebar). The Clone button is
similar to the Modify button since it will present a change form
just as if you've clicked the Modify button. The difference is a
new entry will be created. This is handy if you're programming
ON/OFF times; Insert the ON Event, then clone the ON Event, change
the action to OFF and set the Time.
In the Events Window you can Freeze or Secure Events from the list
box. If you Freeze an Event, an asterisk will be displayed beside
the Event Number. If you Secure an Event, a '≈' will precede the
time. (Secured Events will occur at +/- 30 minutes from the set
time). You can easily swap between Windows by clicking the '' key.
The 'Window' menu item allows you to manage the location and size of
the EVENTS and DEVICES windows. If your display is set for
43/50 line mode, you may find that the Split,Horizontal provides you
with the optimal display. The Unsplit command reverts both Windows
back to their startup state.
You can print an Event or Device listing at anytime using 'Print
Report' under the 'File' menu. Each time you print a report you
have the option of printing directly to your printer or to a file.
The lines per report page can be set from the 'Start Up' options
screen.
Once you're finished updating Event/Devices you can save them to
your designated X10 Startup File (which will appear on the File
Menu), or to any other filename (use 'Save AS'). You can also
upload your Events to the CP290. X10EC gives you 2 choices, you can
upload the modified Events ONLY, or ALL Events. CAUTION: ONLY USE
THE 'UPDATES ONLY' option if you are sure that the currently loaded
Events are based on the Events loaded in the CP290 before you
applied your Updates. If you do not explicitly Save and/or Upload
the program will prompt you to before exiting; UNLESS YOU EXIT USING
THE 'UNCONDITIONAL EXIT' which quickly exits the program without
prompting you to save/upload anything.
9. KEYBOARD USAGE
--------------------------------------------------------------------
Use the TAB/Shift-TAB keys to move among the various controls. The
Up/Down arrows can be used to move up and down List Boxes; the
Spacebar can be used to select the current List Box item. The Enter
key can be used to check/uncheck a check box, or invoke a command
button. The ESCAPE key will exit the current function or the
program if no other windows are visible. Most Command Buttons
and controls have quick access keys which you can identify by
the highlighted character in the button/control name; press the
ALT key + the quick access key to invoke the action.
The menu-bar can be activated by pressing the ALT key, you can use
the cursors keys to navigate the menus, or press the highlighted
character to immediately invoke the desired menu item. Many of the
menu items have short-cut keys. The following list shows ALL menu
items along with the associated short-cut key if one is defined.
-<FILE Menu>-
New
Devices -
Events -
Open X10 File
Retrieve Devices/Events - Ctrl-R
Retrieve Devices ONLY -
Retrieve Events ONLY -
Save X10 File - Ctrl-S
Save X10 File AS - Ctrl-A
Print Report
Print Device Listing -
Print Event Listing - Ctrl-P
Unconditional Exit - Ctrl-Q
Exit - Ctrl-X
-<ACTIONS Menu>-
Refresh Updated
Devices Name - F2
Event Counts - F3
Sort Events By
Location,Description - Shift-F1
Housecode,UnitCode - Shift-F2
Day,Time - Shift-F3
ReCycle Sun Times - F4
Show Sun Times - Ctrl-T
Set CP290 Clock
Enter Time - Ctrl-K
Synchronize w/PC -
Set PC Clock
Enter Time -
Synchronize w/CP290 -
-<TRANSFER Menu>-
Upload Events TO CP290
All Events - Ctrl-U
Updated Events -
Download Events FROM CP290-
Clear Events -
-<OPTIONS Menu>-
Communications - Ctrl-C
Display - Ctrl-G
Startup - Ctrl-B
Sunrise/Sunset Parms -
Save Options - Ctrl-O
-<WINDOW Menu>-
Devices - Ctrl-D
Events - Ctrl-E
Split
Horizontal - Ctrl-H
Vertical - Ctrl-V
Swap - Ctrl-W
UnSplit -
-<HELP MENU>-
Help Information - F1
About - Ctrl-F1
10. STARTUP OPTIONS
--------------------------------------------------------------------
DEVICES & EVENTS
================
The DEVICES Window and EVENTS Window are always opened each time you
start X10EC. You can setup X10EC to automatically populate these
Windows by clicking the appropriate option buttons. The only source
to populate the DEVICES Window is an X10.DAT file; the EVENTS Window
can be populated from either an X10.DAT file or a CP290 download.
Only one X10.DAT startup file can be identified and it will source
both the DEVICES Window and the EVENTS Window (if applicable).
CLOCK
=====
The CP290 or PC Clocks can be synchronized to each other every time
you upload Events. To synchronize the CP290 Clock to your PC Clock,
select 'Sync CP290 on Upload'; this option will examine the PC clock
and then wait until the seconds are at zero before setting the CP290
Clock (the CP290 Clock resolution is limited to minutes). If you
elect to 'Sync PC on Upload' then the PC Clock will be set
immediately just prior to uploading Events. You can also bypass all
Clock Sync'ing by choosing 'Do Not Sychronize'.
GENERAL OPTIONS
===============
General options can be modified at any time while X10EC is executing
and the effect will be immediate.
SUNRISE/SUNSET SUPPORT:
Uncheck if you DO NOT want X10EC to use the ICON memory area of
the CP290; in this case the Relative Time & Last Upload Date/Time
features will be disabled.
LOAD HELP SUBSYSTEM:
Uncheck to save memory and speed up program load time.
CONFIRM DELETE REQUESTS:
Uncheck to delete without confirmation, You may want to turn
off the confirmation if you're doing many deletes,
it's a good idea to leave it checked just in case.
AUTOREFRESH DEVICE NAMES
On slower machines it could become a nuisance to wait for the
program to refresh the Device Names in the EVENT Window
whenever a Device Name is modified. You may want to Refresh 'ON
DEMAND' instead by using F2.
AUTOREFRESH EVENT COUNTS:
See comments re: AUTOREFRESH DEVICE NAMES;Uncheck to Refresh
'ON DEMAND' (F3).
SAVE X-10 FILE UPON RECYCLE:
The RECYCLE process works exclusively with the CP290 (ie. Events
are downloaded from the CP290, Suntimes are refreshed, and the
Events are re-uploaded). Checking this box will instruct X10EC
to save the recycled Events to the RECYCLE.DAT file.
CLOCK REFRESH RATE:
The PC Time & CP290 Time are displayed in the screen header and
can be refreshed periodically by setting a refresh rate greater
than 0.
NOTE:
====
THE FIELD WIDTH IS ONLY 1 CHARACTER AND THE COMPILER DEFAULTS
TO KEYBOARD 'INSERT MODE'; PRESS THE INSERT KEY TO TOGGLE THE
KEYBOARD TO 'TYPEOVER MODE' TO CHANGE REFRESH VALUE.
LINES PER REPORT PAGE
Valid Range is 10-99. (see previous comments re: keyboard
INSERT MODE).
PRINT IBM BOX CHARACTERS:
If your printer is set up to print the IBM ASCII character set
you can improve the appearance of the DEVICE & EVENT printed
reports by checking this box.
11. COMMUNICATION PORTS
--------------------------------------------------------------------
X10EC supports "pseudo standard" CommPorts 1 thru 4 using the
following settings:
+----------+------+------------------+
| | | Base I/O Address |
| CommPort | IRQ +---------+--------+
| | | Decimal | HEX. |
+----------+------+---------+--------+
| 1 | 4 | 1016 | 3F8 |
+----------+------+---------+--------+
| 2 | 3 | 760 | 2F8 |
+----------+------+---------+--------+
| 3 | 4 | 1000 | 3E8 |
+----------+------+---------+--------+
| 4 | 3 | 744 | 2E8 |
+----------+------+---------+--------+
If one of these CommPort settings matches your hardware
configuration simply select the appropriate CommPort from the
Communications Options screen. (You could also start X10EC with the
/C command line argument or use the COMMPORT= X10EC.INI directive).
You can define your own CommPort by selecting User Defined CommPort
from the Communications Options screen and setting the IRQ interrupt
and Base I/O Address. (You could also use the /I and /A Command
Line Args or IRQ= & Base_IO_Address= X10EC.INI file directives).
IRQ can be set to any value between 1 and 15 (inclusive). Base I/O
Address can be set to any value greater than zero. CAUTION: your
hardware may "lock up" if incorrect settings are used. Once you
have enabled communications with the CP290, then use the 'Save
Options' menu item to save the information to the X10EC.INI file.
THE BASE I/O ADDRESS MUST BE SPECIFIED IN DECIMAL NOTATION.
IBM PS/2 CommPort Parameters are shown below:
+----------+------+------------------+
| PS/2 | | Base I/O Address |
| CommPort | IRQ +---------+--------+
| | | Decimal | HEX. |
+----------+------+---------+--------+
| 1 | 4 | 1016 | 3F8 |
| 2 | 3 | 760 | 2F8 |
| 3 | 3 | 12832 | 3220 |
| 4 | 3 | 12840 | 3228 |
| 5 | 3 | 16928 | 4220 |
| 6 | 3 | 16936 | 4228 |
| 7 | 3 | 21024 | 5220 |
| 8 | 3 | 21032 | 5228 |
+----------+------+---------+--------+
A User Defined CommPort must be used for
PS/2 CommPorts 3-8.
12. SCREEN DISPLAY OPTIONS
--------------------------------------------------------------------
This feature allows the user to choose their own screen colours. A
list of screen elements is presented on the left side of the screen
and all of the available Foreground and Background (when applicable)
colours are displayed next to the screen elements. To change a
colour, simply select the screen element you wish to change and
click on the preferred Foreground/Background colours. The Colour
defaults can be restored by clicking on the Colour button, similarly
Black & White colours can be selected by clicking on the Monochrome
button. Note: some colour combinations will render the screen
unreadable, if this happens press the [Esc] key to exit the dialogue
and restore the colours to their previous setting. Once you are
satisfied with your colour selections the 'Save Options' command can
be used to store them so that X10EC always starts up with your
selected colours.
The colours for message boxes cannot be changed (always black
on white;compiler limitation).
There are 3 additional program options that can be set:
THREE-D
The program will attempt to render the screen controls in 3D.
If you choose a bright screen background, the 3D effect will
not be evident and you may wish to turn off THREE-D. It is
also recommended that you turn off THREE-D for Monochrome
Monitors.
WINDOW SHADOW
The program will paint shadows underneath and to the right of
loaded screen windows; this helps to define the boundaries of
pop-up windows. It is recommended that you turn the WINDOW
SHADOW off for Monochrome Monitors.
GRAPHIC GAUGES
The Graphic Gauges checkbox determines whether or not graphical
EGA/VGA characters are used to construct the sliding percentage
complete gauge. If this causes problems with your screen
display, then uncheck the box; the ASCII character '█' 219 will
be used to paint the gauges instead.
13. SUN TIME PARAMETERS
--------------------------------------------------------------------
This screen under the 'Options' menu allows you to set the
Longitude, Latitude & GMT Offset parameters specific to your
location. These parameters are used to calculate your local Sunrise
and Sunset times. The calculated Sunrise/Sunset times will be
accurate to within a minute or two. Sample Longitude & Latitude
parameters for a limited selection of cities can be set by using the
combo box (click on the down arrow or press F4 to expand the list
box). THE GMT OFFSET MUST BE EXPLICITLY SET; it can vary depending
on whether Daylight Savings Time is in effect or not. eg. for the
Eastern Time Zone the GMT Offset is -4 when Daylight Savings Time is
in effect and -5 when it is not. Check 'Observe DST' to have X10EC
automatically vary the GMT Offset while Daylight Savings Time is in
effect [the first Sunday in April through the last Sunday in
October]. When this option is checked the 'effective' GMT Offset
will be displayed below the checkbox. When 'Observe DST' is checked
the GMT Offset you set should be for Standard Time since X10EC will
adjust it for Daylight Savings Time. Note that when X10EC
calculates Sunrise/Sunset times for the next 7 days it will not
adjust the GMT OffSet if Daylight Savings Time begins or ends in the
middle of this period. It is recommended that you RECYCLE each
Sunday so that your Sunrise/Sunset times are always accurate.
You can view the Sun Times for the upcoming 7 days by using the
'Show Sun Times' option under the 'Actions' menu.
Note: when you set a Relative Time and want to see what Absolute
time the Program will upload to the CP290, then use the 'ReCycle
Sun Times' option under 'Actions' and then double-click the Event.
The time is shown in the Absolute Time frame. Note: X10EC will
always 'ReCycle' the Sun Times prior to an upload.
When X10EC encounters a Relative Time it determines the Absolute
Time to upload as follows:
1) It looks at the 'Day(s) of Week' the Event is scheduled,
finds the next Date the Event will run and uses the Sunrise/
Sunset Times for that Day.
2) If the Event is to run today, it will compare the current time
to the Sunrise/Sunset +/- Offset Time. If the time has already
past, then it will use the Sunrise/Sunset time for one week
from today.
3) X10EC will not allow the +/- Offset Time to cause the Event to
span to the previous day or the next day; X10EC will only
negatively Offset a time to 12:00 AM on the scheduled day, it
will only positively Offset a time to 11:59 PM.
14. SAVE OPTIONS
--------------------------------------------------------------------
This menu option saves all of the current program settings to the
X10EC.INI file. If an X10EC.INI file exists, the program will
display a Warning Message and confirm that you wish to overwrite the
existing X10EC.INI file before proceeding. The X10EC.INI file that
X10EC generates is a plain ASCII file that you can edit using your
favourite editor. X10EC will notify you of any errors within the
X10EC.INI by displaying the offending line along with a message
indicating it will be ignored. Note that the X10EC.INI file is
parsed before command line arguments and therefore will be
overridden by contradicting command line arguments.
15. INTELLIGENT EDIT
--------------------------------------------------------------------
X10EC offers some degree of referential integrity when you're
editing Device Names:
- If you modify a Device Address (ie. House and/or Unit Code)
X10EC can optionally examine all of the scheduled Events and
update* any that target the Device to reflect the new
house/unit code.
- If you Delete a Device Description X10EC can optionally
examine all of the scheduled Events and purge* any that are
specifically targetted for the deleted Device.
- If you change a Device Name; any Events which target the
Device will be updated to reflect the new Device Name the
next time the Event list gets focus. (IF AUTOREFRESH Device
Names is checked - otherwise you can press F2 at any time to
refresh Device Names).
-----
* Group and Global Events are left intact; only single unit
Events will be purged/modified.
16. UNDOCUMENTED CP290 COMMANDS
--------------------------------------------------------------------
X10EC supports the following undocumented CP290 commands:
Fade OFF - DIMS Light(s) to 0 then turns Unit(s) OFF
(Can target multiple units for this command)
X-Light ON - Exclusive Light ON - Issues an ALL LIGHTS OFF
then Brightens selected Unit(s)
(Can target multiple units for this command)
ALL Lights ON - All Lights on selected House Code set ON
ALL Lights OFF - All Lights on selected House Code set OFF
ALL Units OFF - All Units on selected House Code set OFF
NOTES: Storing Events with these undocumented commands MAY CAUSE
problems with some CP290 Event Schedulers. These commands
will be transparent to X10.EXE; however, X10.EXE can
only display ON/OFF/DIM. If X10.EXE encounters one of
these undocumented commands it will display it as blank.
X-10 Light Switches usually respond to the ALL LIGHTS ON
command; however some Lamp Modules appear to ignore it;
increasing the DIM level when using this command occasionally
resolves this apparent hardware problem.
17. INCREMENTAL BRIGHTENING
--------------------------------------------------------------------
X-10 Light Switches and Lamp Modules can be incrementally brightened by
sending X-10 BRIGHT commands to them. However, the CP290 controller has
a built-in macro that forces these modules to 100% brightness and then
sends X-10 DIM commands to them to dim them down to the desired
brightness level. This prevents you from gradually brightening a module
over a period of time by sending several DIM commands with increasing
brightness levels (the end result will be the desired brightness level,
but after each command the module will be ramped up to 100% only to be
dimmed back down to the desired brightness level).
The undocumented X-LIGHT command can be used to gradually brighten an
X-10 Lamp Module but not an X-10 Wall Switch due to an inherent anomaly
with the X-10 Lamp Modules. The CP290 acts on an X-LIGHT command by
sending several ALL LIGHTS OFF commands followed by a number of BRIGHT
commands corresponding to the DIM level set. If an X-10 Lamp Module or
Wall Switch is currently off and a BRIGHT or DIM command is sent, that
module will turn ON at 100% and then dim/brighten accordingly. However,
most X-10 Lamp Modules do not respond to the ALL LIGHTS OFF command.
So, when an X-LIGHT command is sent to the CP290 and it generates an ALL
LIGHTS OFF command it will have no impact on the Lamp Module, however,
the Lamp Module will respond to the subsequent BRIGHT commands by
brightening from the current brightness level (without going to 100%
brightness) providing it was NOT OFF to begin with. This means you can
incrementally brighten one or more Lamp Modules by following these
steps:
(1) Dedicate a House Code for those Lamp Modules that you wish to
incrementally brighten. (Otherwise, any Wall Switch Modules on the
same house code will end up at 100% brightness).
(2) Send a DIM Command (0% Brightness) to the targetted Lamp Modules.
(3) Send a variable number of X-LIGHT Commands to the targetted Lamp
Modules.
NOTE, THE BRIGHTNESS LEVELS ASSOCIATED WITH X-LIGHT COMMANDS ARE BOTH
INVERTED AND CUMULATIVE. For example, if you send an X-LIGHT Command
with a brightness level of 80%, the targetted Lamp Module will
incrementally brighten to 20% (assuming it was on at a brightness level
of 0% to begin with). If you send the same command a second time, the
Lamp Module will brighten to 40%. NOTE: The Pop-up X-10 DIRECT COMMAND
PAD uses absolute steps rather than a brightness setting; hence no
inversion is required.
17. DIRECT COMMAND PAD
--------------------------------------------------------------------
X-10 Direct Commands can sent to Devices in the Devices Window; simply
highlight a Device and click the right mouse button (or click the DC
command button). This action will pop-up the X-10 Direct Command Pad
which supports all CP290 X-10 Commands including the Undocumented
Commands. Click on the button corresponding to the X-10 Command you
wish to send and then click on the Send button to send the command.
NOTE: The Brightness/Steps slider control is only enabled when the
selected command is DIM or X-LIGHT. See the INCREMENTAL BRIGHTENING
section for further information on using Absolute Steps with the
X-LIGHT Command.
18. LAST UPLOAD DATE/TIME
--------------------------------------------------------------------
If 'Sunrise/Sunset' support is enabled, X10EC will store the Last
Upload Date/Time in the CP290 Interface. When Events are uploaded
to the CP290, the Last Upload Date/Time is updated. Each time
Events are downloaded from the CP290, the Last Upload Date/Time will
be displayed in the Screen Header (left margin, 3rd line). X10EC
will also extract the Last Upload Date/Time from X10.DAT files when
they are retrieved.
19. CP290 ICON STORAGE
--------------------------------------------------------------------
The CP290 also has memory set aside for Icon storage. The DOS
character-based software does not display any graphical Icons hence
this storage area is unused when the CP290 is used with the X10.EXE
program. X10EC uses this memory area to store Sunrise/Sunset (see
Sun Time Parameters) information applicable to the scheduled Events
as well as the 'Last Upload' Date/Time and other information.
Hence, all Event Information including Sunrise/Sunset Offset
information is stored within the device. This means whenever you
download Event Information from the CP290 the Sunrise/Sunset offset
information is also downloaded; you do not have to 'match' or
'associate' the downloaded events with a data file in order to
translate the 'Absolute' Time of Day back to a 'Relative'
(Sunrise/Sunset +/- Offset) Time. This also provides a complete
backup to the Event Information stored in an X10.DAT file.
You can elect not to use the CP290 Icon Storage area by unchecking
the 'Support Sunrise/Sunset' box on the 'Start Up' options screen.
(This will also disable support for the 'Last Upload Date/Time'
information in the screen header).
20. BATCH MODE PROCESSING
--------------------------------------------------------------------
RECYCLE PROCESS
===============
The RECYCLE Process runs X10EC in Batch Mode and updates any Events
that have been scheduled with Relative Times (ie. Sunset/Sunrise
+/- Offsets). You can specify how many days must elapse between
each RECYCLE Process by using the nn parameter with the /RECYCLE
command line argument. When X10EC encounters the /RECYCLEnn
argument it checks the last run date contained within the X10EC.LOG
file and compares it with today's date; if the number of days that
have elapsed does not exceed nn then the program will immediately
terminate. This allows you to add the following line to your
AUTOEXEC.BAT file:
X10EC /RECYCLE7
X10EC will run every time you boot but will only invoke the RECYCLE
Process if 7 days have elapsed. When a RECYCLE is indicated, the
program will pause 5 seconds before proceeding with the RECYCLE Process.
During this pause you can press the ESC key to bypass RECYCLE Processing
or press ENTER to proceed with RECYCLE processing immediately. To run
the RECYCLE Process unconditionally use the the /RECYCLE0 or /RECYCLE
command line argument. When the RECYCLE Process is invoked, X10EC will
perform the following steps.
- Calculate Sunset/Sunrise Times for the upcoming 7 Days
- Download Event Information from the CP290
- Download Sunset/Sunrise Offset Information from the CP290
- Update Events with Sunset/Sunrise relative times
- Optionally synchronize the CP290 or PC Clock
- Upload any updated Events to the CP290
- Optionally save Events to the RECYCLE.DAT file
- Backup the old X10EC.LOG to X10EC_B.LOG
- Log all activity to X10EC.LOG
Note that the RECYCLE process DOES NOT read EVENT INFORMATION from
the X10 Startup File, this is to ensure that only currently
scheduled Events as stored in the CP290 are updated. (There is no
guarantee that the current X10 Startup File as defined in the
X10EC.INI reflects the contents of the CP290 Event Memory.)
Consequently you may wish to set up X10EC to always download Events
from the CP290 upon startup rather than retrieving Events from the
X10.DAT file.
UPLOAD FILE PROCESS
===================
If you simply want to replace the Events Stored within the CP290
(ie. you may have an X10.DAT file that you use to randomly turn
lights ON & OFF as a security measure while you're on vacation)
then you can use the /UF:[d]\filename command line argument. X10EC
will perform the following steps:
- Calculate Sunset/Sunrise Times for the upcoming 7 Days
- Read Events from the X10.DAT filename passed on the command line
- Update Events with Sunset/Sunrise relative times
- Optionally synchronize the CP290 or PC Clock
- Clear the CP290 Event Memory
- Upload all Events to the CP290
- Backup the old X10EC.LOG to X10EC_B.LOG
- Log all activity to X10EC.LOG
21. COMPATIBILITY ISSUES
--------------------------------------------------------------------
FREEZE
======
X10EC is file compatible with X10.EXE but there are some limitations
associated with partially 'Frozen' Group Events. X10.EXE allows you
to partially freeze Group Events, that is some units within the
group can be frozen whereas other remain scheduled Events. X10EC
does not support this level of granularity for Frozen Events; it
considers any Event either Frozen or Thawed (ie. Not Frozen) and
this applies to single unit Events and multiple unit Events alike.
If a multiple unit Event is Frozen by X10EC then all units defined
to the Event will be Frozen.
X10.EXE relies solely on the X10.DAT file to decipher Frozen Events
that it 'Freezes'. Conversely X10EC can decipher Frozen Events
that it 'Freezes' from either an Event Download or an X10.DAT file.
IMPACT
======
If Events have been FROZEN by X10.EXE, then X10EC.EXE will behave as
follows:
Event Source Event Type Freeze X10EC Interpretation
------------ ----------- ------ ------------------------------
X10.DAT File Single Unit Frozen No impact: will interpret
X10.DAT File Multi-Unit Partial X10EC will capture unFrozen
units only and treat as a
Frozen Event.
X10.DAT File Multi-Unit Frozen No impact: will interpret
CP290 D/L Single Unit Frozen X10EC will NOT capture unit;
will treat as a Frozen Event
CP290 D/L Multi-Unit Partial X10EC will capture unFrozen
units only and treat as an
unFrozen Event
CP290 D/L Multi-Unit Frozen X10EC will NOT capture units;
will treat as a Frozen Event
RECOMMENDATION
==============
If this all seems confusing, just be sure to unFreeze any Events you
have Frozen with X10.EXE before using X10EC.EXE. Any Events Frozen
by X10EC will be translated correctly by X10.EXE if you decide to
fallback to X10.EXE.
FILE COMPATIBILITY
==================
X10.EXE will read and interpret the X10.DAT files created by X10EC
that include X10EC extensions. Of course, the extensions added by
X10EC will be transparent to X10.EXE, however, THEY WILL BE LOST IF
X10.EXE OVERWRITES the file. (Extensions include Sunrise/Sunset
information and Last Upload Date/Time). For this reason, it is
recommended that you create an X10.DAT file for the exclusive use of
X10.EXE rather than sharing a single X10.DAT file between the two
programs.
22. PROBLEM RESOLUTION
--------------------------------------------------------------------
Generally, if your CP290 works with the X-10 supplied software then
you should have no problems running X10EC. X10EC has been
successfully tested under Microsoft Windows v3.1 and OS/2 v2.1. The
program will load if you run it without any arguments (thereby
defaulting to COMMPORT 1) and your CP290 is actually attached to
COMMPORT 2. If this is the case X10EC will report 'Timed Out
waiting for a response' when it attempts to retrieve the CP290 Time,
Day of Week and Base HouseCode. You can toggle to the correct
COMMPORT once the program is running by using the Options,
Communications menu. The Save Options menu option will save all
settings to the X10EC.INI which obviates the need for command line
arguments.
If you run X10EC with a modem attached to the COMMPORT, you may get
unpredictable results since the modem will echo everything back to
X10EC. If you're using a COMMPORT that shares an interrupt with
another COMMPORT (eg. 1 & 3, 2 & 4), then you must ensure that no
memory resident software (eg. a FAX TSR) that uses the other COMMPORT
is loaded as it will not release the interrupt.
If you use a Serial Mouse, this may cause a conflict if X10EC
attempts to communicate with a CP290 on the same CommPort. You may
want to start X10EC with the /C command line argument to ensure it
does not default to CommPort 1 if your mouse is also on CommPort 1.
X10EC will not run properly if it attempts to communicate with a
COMMPORT that has been initialized with a Mouse Driver (ie. you
cannot use a switchbox between the CP290 and a Mouse unless you
reboot without loading the Mouse Driver).
The X10EC executable file is encrypted and there is a remote
possibility that the decryption process may fail with certain
processors; a blank screen immediately after attempting to run the
program typifies this problem. Please contact the author if you
encounter this problem.
The clocks are refreshed in the background and the refresh process
requires serial I/O; if your CP290 is not connected or you are using
a slow processor the refresh process can interrupt the foreground
process to the point where the program seems to be unresponsive;
if you experience this problem then try a Clock Refresh Rate of 0.
If you suspect that your CP290 is failing, you should try using the
diagnostic/debug features provided by X10DC.
In some cases X10EC may report communication errors (ie. time-outs,
unmatched checksums, etc). This may occur when scheduled Events
collide with CP290 Uploads/Downloads that are in progress. (The
CP290 transmits onto the serial port line whenever a scheduled event
occurs and when you press the rocker buttons on the CP290). X10EC
attempts to minimize collisions by discarding unexpected serial
input, however the possibility still exists. You should just
re-invoke the interrupted action to recover from this type of
problem.
The open architecture of the PC compatible operating environment and
the near infinite combinations of hardware and software complicate
the compatibility of applications software. While every effort has
been made to ensure that X10EC is compatible with as many
hardware/software combinations as possible, there may be operating
environments in which X10EC will not run properly.
Problems can be reported to:
David Huras
37 Ruddell Crescent
Georgetown, Ont. L7G 5N4
CANADA
FAX: 905-873-6429
CIS: 72767,472
Internet: davidhuras@inforamp.net
23. REGISTRATION INFORMATION
--------------------------------------------------------------------
The registration fee for X10EC is $25. (US Dollars for US shipping
addresses, CDN Dollars for Canadian shipping addresses). X10EC is
currently supplied as functioning software without built-in delays
or obtrusive "nag" screens prompting you to register. The Relative
Time feature (ie. Sunrise/Sunset support) is the only feature not
supported in the shareware version of X10EC. A SIGNIFICANT amount
of time and effort went into this program; please register the
program if you intend to use it beyond the 30-day evaluation period.
Registered Users will be shipped a printed manual and a 3.5" diskette
(if you would prefer a 5.25" diskette please advise) containing the
registered version of the program. Registration Benefits:
- Full support for the Relative Time feature which allows you
to schedule Events relative to your local Sunset/Sunrise time
offset by up to +/- 255 minutes.
- BONUS PROGRAMS: Registered Users will also receive 2 bonus
programs:
1) X10DAT reads an X10.DAT file and prepares a report
listing all installed devices and scheduled events including
"frozen" events and multiple unit events. See the X10DAT.RPT
file for a report sample.
2) XDC issues immediate X-10 command directives to the CP290
directly from the DOS prompt. Alternatively, you can pass
a filename to XDC containing 'batched' X-10 command directives.
XDC supports the 5 undocumented CP290 commands that are
supported by X10EC & X10DC. See the XDC.DOC file for additonal
information.
- DISCOUNTED REGISTRATION FEE for X10DC; X-10 Direct Control.
Registered Users can register X10DC for $15; the regular
registration fee is $20.
- DISCOUNTED REGISTRATION FEE for X10WC; X-10 Windows Control.
Registered Users can register X10WC for $22; the regular
registration fee is $32.
To expedite your registration, you may wish to register using
CompuServe Shareware Registration; you will receive a Registration
Key via CompuServe E-Mail within 1 business day that will enable the
registered program features. (See CompuServe Shareware Registration
below). Alternatively, you can charge the Registration Fee to your
VISA, Master Card, or American Express. (See PsL Shareware
Registration Program below). If you elect to use either of these
methods your software will ship within 1 business day.
If you do not wish to register via CompuServe Shareware Registration
or the PsL Shareware Registration Program then complete the order
form in the REGISTER.FRM file and send with your payment to:
David Huras
37 Ruddell Crescent
Georgetown, Ont. L7G 5N4
CANADA
CompuServe Shareware Registration
=================================
You can register X10EC, X10DC or BOTH using CompuServe Shareware
Registration. The Registration Fee will be charged to your
CompuServe billing account and the latest version of the software
along with a printed User Guide will be shipped within one business
day. In addition, you will receive a Registration Key via
CompuServe E-Mail (within one business day) that will immediately
allow you to run X10EC with the registered version features enabled
while you wait for your diskette to arrive. GO SWREG while on
CompuServe to use Shareware Registration.
Program Title Program Name Program ID# Charge
=================== ============ =========== =======
X-10 Event Control X10EC 1774 $25.00
X-10 Direct Control X10DC 620 $20.00
X-10 Control Bundle X10CB 1775 $40.00
(X10DC + X10EC)
X10WC CompuServe Registration
=============================
You can also register X10WC using CompuServe Shareware
Registration. The Registration Fee will be charged to your
CompuServe billing account and a Registration Key File will be
forwarded to you via Compuserve E-Mail within 1 business day. This
Registration Key File will immediately allow you to run the current
and future versions of X10WC with all of the registered features
enabled. A diskette will NOT be shipped to you if you elect to
register using Compuserve Shareware Registration, however, once you
are a registered user you can order a diskette upgrade at any time
for $2.00; see DISKETTE.FRM. GO SWREG to access CompuServe
Shareware Registration.
Program Title Program Name Program ID# Charge
=================== ============ =========== =======
X-10 Windows Control X10WC 5226 $32.00
X10EC -> X10WC Upgrade* X10EW 5227 $22.00
-----
* To use the X10EC-> X10WC upgrade you must have registered
X10EC (or X10CB) using CompuServe Shareware Registration.
PsL Shareware Registration Program
==================================
Charge the Registration Fee to your Visa, Master Card, or American
Express by ordering X10EC or X10DC (specify Program # below) from
Public (software) Library, call 800-242-4PsL (713-524-6394 overseas)
or FAX your order to 713-524-6398. PsL will forward your order to me
via Compuserve E-Mail and your order will be shipped within one
business day. Note, these phone numbers are for ordering only. ALL
OTHER INQUIRIES (eg. technical support, volume discounts site
licensing) should be directed to the author: see program
documentation.
Program Title Name Program # Charge Handling Total
=================== ====== ========= ====== ======== ======
X-10 Event Control X10EC 11595 $25.00 $1.00 $26.00
X-10 Direct Control X10DC 10924 $20.00 $0.00 $20.00
X-10 Windows Control X10WC 14258 $32.00 $1.00 $33.00
You can also register via PsL on the Internet by accessing URL:
WWW: http://206.109.101.6/cgi-win/psl_ord.exe/item11595
24. UPGRADE INFORMATION
--------------------------------------------------------------------
Quick Upgrade
=============
REGISTERED USERS of prior versions of X10EC can immediately run the
shareware version of X10EC v1.10 and all future shareware versions
of X10EC with the registered features enabled. X10EC will look in
the current sub-directory for the X10EC.KEY file; if a valid file is
found then X10EC will enable all registered program features. This
means you can upgrade by downloading the latest shareware version of
X10EC and ensuring that your X10EC.KEY file resides in the same
sub-directory.
Existing Registered Users
=========================
If you registered a version of X10EC prior to 1.10; then you are
entitled to an X10EC.KEY file that will enable you to immediately
use the shareware version of X10EC v1.10 with the registered
features enabled. Your X10EC.KEY file can be forwarded via
CompuServe E-Mail, Internet E-Mail, or you can download it directly
from the author. Please contact the author via E-Mail or FAX to
arrange for the delivery of your X10EC.KEY file.
Diskette Upgrade
================
REGISTERED USERS of X10EC can request a diskette containing the
current version of the software at ANY TIME by completing the order
form in the DISKETTE.FRM file and sending it along with $2 for
postage to the author.
25. RELEASE HISTORY - X10EC Shareware/Registered Version
--------------------------------------------------------------------
Date Version Changes
------ ---------- ----------------------------------------------
MAY'96 1.30 - Added pop-up X-10 Direct Command Pad
- Added RECYCLE Process Bypass feature
- Added support for Right Click Event Edit
- Updated Author E-Mail Address
MAR'95 1.20 - Upgraded encryption scheme to improve program
compatibility
- Clock Synchronization Function added for
CP290 and PC
- Clock Setting Function changed from 24 Hour
clock to 12 Hour AM/PM clock
- Save X-10 File Upon RECYCLE option added to
Startup Options
- /UF:filespec argument validation improved
- Typo in 'Save Events' dialogue corrected
JAN'95 1.12 - Refresh of Last Upload Date added after a
'New Events' Window requested
NOV'94 1.11 - Corrected text misalignment of Event Counts
after an Event Count Refresh
- Optimized Event Refresh process for improved
performance
SEP'94 1.10 - Daylight Savings Time Support Added
- Synchronize CP290/PC Clock on Upload Feature
Added
- Set CP290/PC Clock Feature Added
- X10.DAT File Event Merge Support Added
- RECYCLE Process enhanced to accept frequency
parameter
- UPLOAD FILE Batch Mode Process Added
- Bypass Devices (/BYD) command line argument
added
- Bypass Events (/BYE) command line argument
added
- QUICK Registration/Upgrade Feature Added
- 'CP290 Clock Refresh' Startup Option renamed
to 'Clock Refresh Rate'; now applies to both
the CP290 Time and PC Time displayed in the
Screen Header.
- Display Options Short-Cut Key (Ctrl-G) Added
- INI Parse enhanced to report Line Number
when an invalid INI directive is detected
- Clock Refresh Rate defaulted to 0.
- Persistent Window Split Support Added.
JUL'94 1.04 - Corrected problem with Startup Option
AUTOREFRESH EVENT COUNTS checkbox always
displaying as 'checked' regardless of actual
setting (thanks Doug J.)
- Corrected problem with menu-driven Refresh
of Updated Event Counts following an Event
Sort (thanks Doug J.)
JUL'94 1.03 - Corrected problem with non-persistent Display
Options: THREE-D & SHADOWS (thanks Doug J.)
JAN'94 1.02 - Corrected problem with 12:00 PM scheduled
event time (thanks Paul S.)
DEC'93 1.01 - Fixed problem whereby Hilite3 assumed Hilite2
colour when Screen Colours dialogue cancelled
- Fixed CP290 Day field width problem
(occurs on Wednesday only)
DEC'93 1.00 First Public Release
DEC'93 1.00 ß.02 - Added Upload prompt when EVENTS window
unloaded (and Events updated)
- Fixed IRQ/Base_IO_Address default when
only 1 present
- Clear CP290 on Upload ALL Events (faster
than clearing individually)
- Added WARNING TITLE color to Save Options
prompt
- Fixed TITLE when Retrieving Devices ONLY
DEC'93 1.00 ß.01 - Added CLS to Program Exit (To Clear
Screen)
- Added UnSplit Menu Item: EVENTS/DEVICES
Windows revert to Startup Size
- CP290 Clock Refresh defaulted to 1 Minute
(match PC Clock Refresh)
- /F Switch corrected to bypass colon (":")
- Short-Cut Key pass thru: added work-around
code to block short-cut keys when modal
form displayed (compiler bug).
- Changed 'X10.DAT File' reference to 'X10
File' on Startup Options
- Corrected 'Screen Colors' problem whereby
Text Hilights 1,2,3 would revert to black
when dialogue was Cancel'd
- Added SPACEBAR as keyboard equivalent to
DoubleClick in EVENTS/DEVICES list boxes
NOV'93 1.00 ß.00 Initial Beta Version
26. ACKNOWLEDGMENTS
--------------------------------------------------------------------
Special Thanks to Gary Soles & Douglas Johnson, Beta Testers.
---------------------END OF X10EC.DOC-------------------------------